Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Media Functions / Selecting Media Handlers

GetMediaHandlerDescription

The GetMediaHandlerDescription function allows your application to retrieve information about a media handler. You specify the media.

pascal void GetMediaHandlerDescription (Media theMedia, 
                                    OSType *mediaType, 
                                    Str255 creatorName, 
                                    OSType *creatorManufacturer);

theMedia

Specifies the media for this operation. Your application obtains this media identifier from such Movie Toolbox functions as NewTrackMedia and GetTrackMedia (described on page 2-138 and page 2-190, respectively).

mediaType

Contains a pointer to a field of data type OSType. The Movie Toolbox returns the media type identifier. This value indicates the type of media supported by this media handler. This value also corresponds to the component subtype specified for the media handler component. If you do not want to receive this information, set the mediaType parameter to nil. The following values are available:

VideoMediaType

Video media

SoundMediaType

Sound media

TextMediaType

Text media

creatorName

Points to a string. The Movie Toolbox returns the name of the media handler's creator. If you do not want to receive this information, set this parameter to nil.

creatorManufacturer

Contains a pointer to a long integer. The Movie Toolbox returns the 4-byte value that identifies the manufacturer of the component. If you do not want to retrieve this information, set this parameter to nil.

DESCRIPTION

The Movie Toolbox returns information about that media's media handler. This information describes the media handler that created the media, not the handler that is currently assigned to the media.

ERROR CODES

invalidMedia

-2008

This media is corrupted or invalid